home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Collection of Tools & Utilities
/
Collection of Tools and Utilities.iso
/
clipper
/
nftroff.zip
/
11.tr
< prev
next >
Wrap
Text File
|
1991-11-21
|
63KB
|
2,987 lines
.de }n
.bp
.sp .5i
..
.wh -.8i }n
.sp .5i
.po -.4i
.ll 7.5i
.ps 9
.vs 9
.in 0i
.ta 1.63265i
.sp 2
.ne 20
.ps +3
.vs +3
@\.\.\.PROMPT Define a menu item for use with MENU TO
.br
.ta
.in 0.08i
.ps -3
.vs -3
.sp 2
\fB@\.\.\.PROMPT
Define a menu item for use with MENU TO
.in 0i
.br
\l'6.24i'
.br
.sp
.in 0.08i
\fBSyntax
.sp
.in 0.4i
.br
\fB#include "FTMENUTO\.CH"
.in 0i
.br
\fB
.in 0.4i
.ta 4.96i
.br
\fB@ <nRow>, <nCol> PROMPT <cMenuItem> ;
.br
.ta
.in 2.32i
.ta 3.04i
.br
\fB[ PROMPTCOLOR <cPromptColor> ] ;
.br
.ta
.ta 3.04i
.br
\fB[ MESSAGE <cItemMessage> ] ;
.br
.ta
.ta 3.04i
.br
\fB[ MSGROW <nMessageRow> ] ;
.br
.ta
.ta 3.04i
.br
\fB[ MSGCOL <nMessageCol> ] ;
.br
.ta
.ta 3.04i
.br
\fB[ MSGCOLOR <cMsgColor> ] ;
.br
.ta
.ta 3.04i
.br
\fB[ HOTKEY <nHotKeyPosition> ] ;
.br
.ta
.ta 3.04i
.br
\fB[ HOTKEYCOLOR <cHotKeyColor> ] ;
.br
.ta
.ta 3.04i
.br
\fB[ BARCOLOR <cBarColor> ] ;
.br
.ta
.ta 3.04i
.br
\fB[ BARHOTKEYCOLOR <cBarHotKeyColor> ] ;
.br
.ta
.ta 3.04i
.br
\fB[ UP <nUp> ] ;
.br
.ta
.ta 3.04i
.br
\fB[ DOWN <nDown> ] ;
.br
.ta
.ta 3.04i
.br
\fB[ RIGHT <nRight> ] ;
.br
.ta
.br
\fB[ LEFT <nLeft> ]
.sp
.in 0.08i
\fBArguments
.sp
.in 0.4i
\fB<nRow>\fR is the row at which the prompt is to appear\.
.sp
\fB<nCol>\fR is the column at which the prompt will appear\.
.sp
\fB<cMenuItem>\fR is the menu item to display\.
.sp
\fB<cPromptColor>\fR is optional and is the color attribute of the
prompt\. If not specified, the default is the current
standard color as supplied by the SetColor() function\.
.sp
\fB<cItemMessage>\fR is optional and is the message associated with
the prompt\. If not specified, then no message will be displayed\.
.sp
\fB<nMessageRow>\fR is optional and is the row at which the
message, if any, will appear\. If not specified, the default
is the current setting of the SET MESSAGE TO command\.
.sp
\fB<nMessageCol>\fR is optional and is the column at which the
message, if any, will appear\. If not specified, the default
is either zero or centered, depending on the current setting
of the CENTER option of the SET MESSAGE TO command\.
.sp
\fB<cMsgColor>\fR is optional and is the color attribute of
the message\. If not specified, the default is the current
standard color as reported by the SetColor() function\.
.sp
\fB<nHotKeyPosition>\fR is optional and is the position within the
prompt string where the hotkey is located\. If not
specified, the default is one\.
.sp
\fB<cHotKeyColor>\fR is optional and is the color attribute of the
hotkey character\. If not specified, the default is the same
color as the rest of the prompt\.
.sp
\fB<cBarColor>\fR is optional and is the color attribute of
the light bar when it is positioned on this prompt\. If not
specified, the default is the current enhanced color setting
as returned by the SetColor() function\.
.sp
\fB<cBarHotKeyColor>\fR is optional and is the color
attribute of the hotkey when the light bar is positioned on
this prompt\. If not specified, the default is the same
color as the rest of the light bar\.
.sp
\fB<nUp>\fR is optional and specifies which prompt becomes active
when the up arrow key is pressed\. If not specified, the
default is the previous prompt\. The current setting of SET
WRAP TO is obeyed\.
.sp
\fB<nDown>\fR is optional and specifies which prompt becomes
active when the down arrow key is pressed\. If not
specified, the default is the next prompt\. The current
setting of SET WRAP TO is obeyed\.
.sp
\fB<nRight>\fR is optional and specifies which prompt becomes
active when the right arrow key is pressed\. If not
specified, the default is the next prompt\. The current
setting of SET WRAP TO is obeyed\.
.sp
\fB<nLeft>\fR is optional and specifies which prompt becomes
active when the left arrow is pressed\. If not specified,
the default is the previous prompt\. The current setting of
SET WRAP TO is obeyed\.
.sp
.in 0.08i
\fBDescription
.sp
.in 0.4i
This enhanced version of @\.\.\.PROMPT requires the inclusion of
the header file FTMENUTO\.CH in any source file that uses it\.
It is compatible with, and may be used in place of, the standard
Clipper @\.\.\.PROMPT command\.
.sp
Clipper\'s @\.\.\.PROMPT and MENU TO commands are fine as far as
they go\. But many times you need more flexibility\. As
you\'ll no doubt notice if you read the argument list, this
function is almost completely flexible\. You can adjust
locations and colors for every part of the prompt and its
associated message\. In addition, since you can control the
effect of the arrow keys, you can allow both horizontal and
vertical movement, or even disable certain arrow keys if you
so desire\.
.sp
Note that this command can also be called using function-style
syntax\. See the entry for FT_PROMPT() for further details\.
.sp
Also note that this command calls an internal routine called
__FTPROMPT()\. __FTPROMPT() was written in assembler\. Check
the file TMENU\.ASM if you\'re interested in seeing the
assembler source code\.
.sp
All the examples below use the command version\. If you\'re
interested in seeing the function version, compile the
examples with the /P switch and then examine the resulting
\.PPO file\.
.sp
.in 0.08i
\fBExamples
.sp
.in 0.32i
.br
#include "FTMENUTO\.CH"
.br
// Simple prompt
.br
@ 1, 1 PROMPT "Menu choice #1"
.sp
.br
// Prompt with color
.br
@ 3, 1 PROMPT "Menu choice #2" PROMPTCOLOR W+/R
.sp
.br
// Prompt with a message
.br
@ 5, 1 PROMPT "Menu choice #3" MESSAGE "Go to lunch"
.sp
.br
// Prompt with pinpoint message control
.br
@ 7, 1 PROMPT "Menu choice #4" MESSAGE "Drop Dead" ;
.in 1.52i
.br
MSGROW 22 MSGCOL 4 MSGCOLOR GR+/N
.sp
.in 0.32i
.br
// Prompt with a unique lightbar color
.br
@ 9, 1 PROMPT "Menu choice #5" BARCOLOR BG+/W
.sp
.br
// Prompt with a hotkey ("#" character)
.br
@11, 1 PROMPT "Menu choice #6" HOTKEY 13
.sp
.br
// Prompt with pinpoint hotkey control
.br
@13, 1 PROMPT "Menu Choice #7" HOTKEY 13 ;
.in 1.52i
.br
HOTKEYCOLOR R+/BG BARHOTKEYCOLOR G+/N
.sp
.in 0.32i
.br
// Prompt with right and left arrow keys disabled
.br
@15, 1 PROMPT "Menu Choice #8" RIGHT 8 LEFT 8
.sp
.in 0.08i
\fBHeader File:\fR FTMENUTO\.CH
.sp
\fBSource:\fR ATPROMPT\.PRG
.sp
\fBAuthor:\fR Ted Means
.in 0i
.sp
.in 1.5i
.ti -1.5i
.ta 1.5i
.ft B
See Also:
.ft R
MENU TO
, FT_PROMPT()
, FT_MENUTO()
.ta 1.63265i
.in 0i
.sp 2
.ne 20
.ps +3
.vs +3
FT_ACH2TB() Replace ACHOICE() with a Tbrowse object
.br
.ta
.in 0.08i
.ps -3
.vs -3
.sp 2
\fBFT_ACH2TB()
Replace ACHOICE() with a Tbrowse object
.in 0i
.br
\l'6.24i'
.br
.sp
.in 0.08i
\fBSyntax
.sp
.in 0.4i
.ta 5.92i
.br
\fBFT_Ach2tb( <nToprow>,<nTopcol> [, <nBotrow> ][, <nBotcol> ],<aArray>, ;
.br
.ta
.in 0.88i
.ta 5.68i
.br
\fB[ <cBoxtype> ],[ <cBoxcolor> ],[ <cBoxtitle> ],[ <nTitlePos> ], ;
.br
.ta
.ta 5.68i
.br
\fB[ <cUselcolor> ],[ <cTitlecolor> ],[ <cBarcolor> ],[ <cHkcolor> ], ;
.br
.ta
.ta 5.68i
.br
\fB[ <cShadow> ],[ <lExecute> ],[ <nMsgrow> ],[ <nMsgcol> ], ;
.br
.ta
.ta 5.28i
.br
\fB[ <cMsgcolor> ],[cElevbar],[cEbarcolor],[ <cEbarside> ], ;
.br
.ta
.ta 5.76i
.br
\fB[ <cNoSelcolor> ],[ <cTagch> ],[ <nStartelem> ],[ <lRestscrn> ], ;
.br
.ta
.br
\fB[ <nTimeout> ],[ <bUserfunc> ] )
.in 0.48i
.br
\fB-> nOption
.sp
.in 0.08i
\fBArguments
.sp
.in 0.16i
.ta 0.96i
\fB<nToprow>\fR is the top row of the box to be drawn\. Required\.
.br
.ta
.sp
.ta 0.96i
\fB<nTopcol>\fR is the top column of the box to be drawn\. Required\.
.br
.ta
.sp
.ta 0.96i
\fB<nBotrow>\fR is the bottom row of the box to be drawn\. The default is
.br
.ta
.in 0.4i
\fB<nToprow>+Len(\fR<aArray>)+1 or maxrow()-2, whichever is less\.
.sp
.in 0.16i
.ta 0.96i
\fB<nBotcol>\fR is the bottom column of the box to be drawn\. The default
.br
.ta
.in 0.4i
is \fB<nTopcol>+width of the widest element in \fR<aArray>+2\.
.sp
.in 0.16i
.ta 0.96i
\fB<aArray>\fR is the array of options to present to the user\. Each
.br
.ta
.in 0.4i
element can hold as many as five subelements, or as few as one\.
Required\. Additional documentation below, in "Description\."
.sp
.in 0.16i
\fB<cBoxtype>\fR is the type of box to draw\. Uses DispBox()\. The
.in 0.4i
default is a double-line box\.
.sp
.in 0.16i
\fB<cBoxcolor>\fR is the color with which to draw the box\. The default is
.in 0.4i
Setcolor()\.
.sp
.in 0.16i
\fB<